fix daemon HyperFrames scaffold and runtime by Siri-Ray · Pull Request #7030 · nexu-io/open-design

Siri-Ray · 2026-08-18T06:23:50Z

Why

HyperFrames creation could fail before hyperframes.json existed because both project setup and rendering delegated runtime selection to an ambient npx installation. On Apple Silicon, a stale or incompatible native sharp artifact in the user npm cache caused initialization to exit early; the daemon then correctly rejected the directory as an incomplete HyperFrames project.

The author use case is making in-app HyperFrames generation reliable in development and packaged builds without depending on a user's npm cache, global skill installation, or PATH-selected CLI.

What users will see

HyperFrames tasks create a deterministic hidden composition scaffold through Open Design.
Rendering uses the HyperFrames CLI version pinned and packaged with the daemon instead of invoking npx.
Working composition files remain under .hyperframes-cache; the final MP4 remains the only project-root deliverable.
The same scaffold capability is available through the daemon API and od media scaffold --json.

Surface area

Screenshots

Not applicable — this PR does not change the UI.

Bug fix verification

Red: the renderer regression reproduced spawn npx ENOENT when no ambient npx was available, proving rendering still depended on external CLI resolution.
Green: apps/daemon/tests/media/hyperframes.test.ts now verifies the pinned Node/CLI invocation without npx.
New scaffold helper, authenticated route, CLI, prompt, runtime-env, server-bootstrap, and packaged-dependency regressions cover the complete setup-to-render boundary.

Validation

pnpm install --frozen-lockfile
pnpm guard
pnpm typecheck
daemon focused Vitest: 8 files, 100 tests passed
tools-pack Vitest: 38 files, 279 passed, 8 skipped
generated scaffold HyperFrames lint: 0 errors, 0 warnings
real MP4 smoke reached the FFmpeg preflight; this machine does not currently have FFmpeg/FFprobe installed, so final encoding was not claimed as completed

github-actions · 2026-08-18T06:36:16Z

🚀 Landing page preview

This PR is deployed to a Cloudflare Pages preview — not staging or production:

Stable alias: https://pr-7030.open-design-landing-staging.pages.dev
This build: https://f0219510.open-design-landing-staging.pages.dev
Updated for commit e909342.

…-runtime # Conflicts: # apps/daemon/src/server.ts # apps/daemon/tests/prompts/__snapshots__/system-prompt-matrix.test.ts.snap # design-templates/hyperframes/references/html-in-canvas.md # plugins/_official/examples/hyperframes/references/html-in-canvas.md

lefarcen · 2026-08-18T08:02:32Z

Quick heads-up: this PR touches user-visible daemon/CLI runtime behavior, so it will need a manual QA pass before merge — please hold off self-merging for now; we'll loop QA in once it's merge-ready.

Also, could you update the PR body's Surface area checklist? The rest of the write-up is clear, but that section should reflect the CLI/API/extension-point/default-behavior changes called out elsewhere in the description.

lefarcen · 2026-08-18T08:02:54Z

Quick heads-up: this PR touches user-visible daemon/CLI runtime behavior, so it will need a manual QA pass before merge — please hold off self-merging for now; we'll loop QA in once it's merge-ready.

Also, could you update the PR body's Surface area checklist? The rest of the write-up is clear, but that section should reflect the CLI/API/extension-point/default-behavior changes called out elsewhere in the description.

mrcfps · 2026-08-18T09:46:12Z

@Siri-Ray I'm holding off on generating review comments for #7030 because this pull request has merge conflicts right now.

Please resolve the conflicts with main and push the updated branch. Once that's done, request or wait for the review to run again and I'll take another look.

_{🔁 Powered by Looper · runner=reviewer · agent=opencode · An autonomous AI dev team for your GitHub repos.}

Generated-By: looper 0.11.8 (runner=fixer, agent=codex)

github-actions · 2026-08-18T10:02:33Z

Visual regression review

Head: e909342 · Base: 67576cb

0 changed · 49 unchanged · 0 new without baseline · 0 failed

Unchanged cases

Case	Main	PR	Diff
visual-avatar-local-agent-list _{0 px (0.00%)}
visual-avatar-local-agent-list-panel _{0 px (0.00%)}
visual-avatar-menu _{0 px (0.00%)}
visual-avatar-menu-panel _{0 px (0.00%)}
visual-avatar-open-design-model-picker _{0 px (0.00%)}
visual-critical-settings _{0 px (0.00%)}
visual-critical-workspace _{0 px (0.00%)}
visual-critical-workspace-preview _{0 px (0.00%)}
visual-design-system-detail _{0 px (0.00%)}
visual-design-systems _{0 px (0.00%)}
visual-home _{0 px (0.00%)}
visual-home-catalog _{0 px (0.00%)}
visual-home-context-picker _{0 px (0.00%)}
visual-home-context-picker-popover _{0 px (0.00%)}
visual-home-plugin-filter _{0 px (0.00%)}
visual-home-plugin-use-staged _{0 px (0.00%)}
visual-home-plugin-use-with-query _{0 px (0.00%)}
visual-home-staged-attachment _{0 px (0.00%)}
visual-integrations _{0 px (0.00%)}
visual-integrations-mcp _{0 px (0.00%)}

Visual diff is advisory only and does not block merging.

mrcfps · 2026-08-18T11:52:18Z

@Siri-Ray I'm holding off on generating review comments for #7030 because this pull request has merge conflicts right now.

Please resolve the conflicts with main and push the updated branch. Once that's done, request or wait for the review to run again and I'll take another look.

_{🔁 Powered by Looper · runner=reviewer · agent=opencode · An autonomous AI dev team for your GitHub repos.}

Generated-By: looper 0.11.8 (runner=fixer, agent=codex)

AmyShang-alt

@Siri-Ray

Thanks for the contribution. I completed packaged-runtime QA for this PR. I am requesting changes because the final macOS arm64 app cannot load the bundled HyperFrames CLI; the inline comment includes the isolated-package reproduction and required follow-up.

lefarcen · 2026-08-18T16:09:10Z

Hey @Siri-Ray — packaged-runtime QA has now identified the current blocker on this head: the bundled HyperFrames CLI is still missing its native sharp dependency closure in the final packaged app, so the packaged smoke path fails before render.

The concrete repro and expected follow-up are already captured in @AmyShang-alt's blocking review comment above, so the next step is to fix that packaged payload path and push an updated head for QA to re-run.

💡 To drive this PR to merge hands-free, paste this to your AI coding agent (Claude Code / Codex / opencode / Cursor …):
Take over nexu-io/open-design#7030 until it merges — read https://raw.githubusercontent.com/nexu-io/looper/main/skills/pr-takeover/SKILL.md and follow it.

Copy the target-native sharp closure into final standalone payloads and execute the packaged HyperFrames CLI during afterPack. Generated-By: looper 0.11.8 (runner=fixer, agent=codex)

Siri-Ray · 2026-08-18T16:22:42Z

Looper fixer round complete — c1ea0fb

✅ Review comment on tools/pack/src/mac-prebundle.ts:29 (@AmyShang-alt) — thread
- Added sharp to the macOS and Windows prebundle maps, restored its platform-native closure after pruning, and made afterPack execute HyperFrames from the final packaged app. A real macOS build now contains 17,777,811 libvips bytes and reports HyperFrames 0.8.1.

_{🔁 Powered by Looper · runner=fixer · agent=codex · An autonomous AI dev team for your GitHub repos.}

Only chmod the copied fallback so a successful hard link does not try to change the CI-owned Node inode. Generated-By: looper 0.11.8 (runner=fixer, agent=codex)

open-design-crew

QA accepted on head e909342.

The previous packaged-runtime blocker is resolved:

The final macOS app contains sharp and its Darwin ARM64/libvips native runtime closure.
The packaged HyperFrames CLI reports 0.8.1 and passes lint in an isolated environment without ambient npx.
A real packaged render completed successfully (H.264, 1920x1080, 1 second).
Focused tools-pack tests: 39 passed.
Focused daemon/HyperFrames tests: 8 passed.
Required GitHub checks are green, including Windows tools-pack payload coverage.

Residual sampling recommendation: run one full installed-package render on Windows before release. This is non-blocking for this PR.

The reported packaged sharp dependency blocker was fixed on head e909342 and revalidated with a real isolated packaged render. Superseded by QA approval review #4968060456.

lefarcen · 2026-08-19T03:19:10Z

All gates look green now — this looks ready for maintainer merge. Thanks @Siri-Ray + @nettee!

open-design-release-bot · 2026-08-19T03:26:24Z

Created backport PR for release/v0.20.0:

[backport release/v0.20.0] fix daemon HyperFrames scaffold and runtime #7105 with remaining conflicts!

Please cherry-pick the changes locally and resolve any conflicts.

git fetch origin backport-7030-to-release/v0.20.0
git worktree add --checkout .worktree/backport-7030-to-release/v0.20.0 backport-7030-to-release/v0.20.0
cd .worktree/backport-7030-to-release/v0.20.0
git reset --hard HEAD^
git cherry-pick -x 0d53c96bebb6caa4e23fdcc0f1c256b7f26e033c
git push --force-with-lease

fix daemon HyperFrames scaffold and runtime

f17f141

Siri-Ray added 2 commits August 18, 2026 15:29

fix CI snapshots and Nix hashes

e46c650

lefarcen requested a review from nettee August 18, 2026 07:35

lefarcen added size/XXL PR changes 1500+ lines risk/high High risk: apps/desktop, daemon, auth, migration, workflows, package deps type/bugfix Bug fix labels Aug 18, 2026

Siri-Ray marked this pull request as ready for review August 18, 2026 07:55

Siri-Ray requested a review from a team as a code owner August 18, 2026 07:55

lefarcen added the needs-validation Runtime change detected; needs human or /explore agent validation. label Aug 18, 2026

merge main and refresh HyperFrames prompt snapshots

8399a45

Generated-By: looper 0.11.8 (runner=fixer, agent=codex)

Siri-Ray added the backport release/v0.20.0 Backport this fix to release/v0.20.0 label Aug 18, 2026

merge main and resolve HyperFrames route imports

fde7444

Generated-By: looper 0.11.8 (runner=fixer, agent=codex)

AmyShang-alt previously requested changes Aug 18, 2026

View reviewed changes

Comment thread tools/pack/src/mac-prebundle.ts

fix(pack): preserve HyperFrames sharp runtime

c1ea0fb

Copy the target-native sharp closure into final standalone payloads and execute the packaged HyperFrames CLI during afterPack. Generated-By: looper 0.11.8 (runner=fixer, agent=codex)

test(pack): avoid chmod on linked Node fixture

e909342

Only chmod the copied fallback so a successful hard link does not try to change the CI-owned Node inode. Generated-By: looper 0.11.8 (runner=fixer, agent=codex)

open-design-crew Bot approved these changes Aug 19, 2026

View reviewed changes

open-design-crew Bot added validated Runtime change validated (via /explore Pass or manual QA). and removed needs-validation Runtime change detected; needs human or /explore agent validation. labels Aug 19, 2026

nettee approved these changes Aug 19, 2026

View reviewed changes

AmyShang-alt added this pull request to the merge queue Aug 19, 2026

Merged via the queue into main with commit 0d53c96 Aug 19, 2026
34 checks passed

open-design-release-bot Bot mentioned this pull request Aug 19, 2026

[backport release/v0.20.0] fix daemon HyperFrames scaffold and runtime #7105

Merged

Navigation Menu

Uh oh!

fix daemon HyperFrames scaffold and runtime - #7030

fix daemon HyperFrames scaffold and runtime#7030
AmyShang-alt merged 7 commits into
mainfrom
agent/fix-hyperframes-runtime

Siri-Ray commented Aug 18, 2026

Uh oh!

github-actions Bot commented Aug 18, 2026 •

edited

Loading

Uh oh!

lefarcen commented Aug 18, 2026

Uh oh!

lefarcen commented Aug 18, 2026

Uh oh!

mrcfps commented Aug 18, 2026

Uh oh!

github-actions Bot commented Aug 18, 2026 •

edited

Loading

Uh oh!

mrcfps commented Aug 18, 2026

Uh oh!

AmyShang-alt left a comment

Uh oh!

Uh oh!

lefarcen commented Aug 18, 2026

Uh oh!

Siri-Ray commented Aug 18, 2026

Uh oh!

open-design-crew Bot left a comment

Uh oh!

lefarcen commented Aug 19, 2026

Uh oh!

Uh oh!

open-design-release-bot Bot commented Aug 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

Siri-Ray commented Aug 18, 2026

Why

What users will see

Surface area

Screenshots

Bug fix verification

Validation

Uh oh!

github-actions Bot commented Aug 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Landing page preview

Uh oh!

lefarcen commented Aug 18, 2026

Uh oh!

lefarcen commented Aug 18, 2026

Uh oh!

mrcfps commented Aug 18, 2026

Uh oh!

github-actions Bot commented Aug 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Visual regression review

Uh oh!

mrcfps commented Aug 18, 2026

Uh oh!

AmyShang-alt left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lefarcen commented Aug 18, 2026

Uh oh!

Siri-Ray commented Aug 18, 2026

Uh oh!

open-design-crew Bot left a comment

Choose a reason for hiding this comment

Uh oh!

lefarcen commented Aug 19, 2026

Uh oh!

Uh oh!

open-design-release-bot Bot commented Aug 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

github-actions Bot commented Aug 18, 2026 •

edited

Loading

github-actions Bot commented Aug 18, 2026 •

edited

Loading